Customizing the AI Assistant Avatar

Wherever the AI Assistant is represented in the chat — the welcome screen, each reply, the thinking indicator, the streaming reply, and the conversation-list header — WebWorks Reverb 2.0 renders an avatar. Since 2026.1, that avatar is the image configured for the assistant on the WebWorks Platform. An assistant with no avatar configured keeps the generic icon, and so does an avatar whose image cannot be loaded, so output for an assistant without an avatar looks exactly as it did before. For instructions on setting the avatar, see Set Up a Reverb 2.0 Target and AI Assistant.

The avatar container is styled from the $assistant_avatar_* variables in _colors.scss and _icons.scss, which set the background tint and the generic icon. Those values suit the icon. A photographic avatar often reads better in a plain container, so to style the two states apart, target these class names from custom.scss:

Class

Applies to

ww_skin_assistant_avatar

Every avatar slot, whether it holds the image or the generic icon. Its size is fixed per slot, so nothing shifts while the image loads.

ww_skin_assistant_avatar_has_image

Added alongside ww_skin_assistant_avatar only while the slot is showing the configured avatar image. It is removed again if the image fails to load and the slot falls back to the icon.

ww_skin_assistant_avatar_image

The avatar image itself. It fills its container and is cropped to the container's corner radius.

For example, to drop the icon's background tint when a real avatar is present:

.ww_skin_assistant_avatar_has_image {
  background-color: transparent;
}
Last modified date: 08/17/2026